home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / utilities / utility_02 / converters / !CGM->Draw / !Help next >
Text File  |  1995-02-19  |  13KB  |  372 lines
  1.                       
  2.                             CAREWARE
  3.                           ############
  4.  
  5.  
  6.                     !CGM->Draw Version 2.9 Readme.
  7.  
  8.  
  9. Last updated 
  10. ~~~~~~~~~~~~
  11.    Application   :  19th  Feb  1995
  12.    Documentation :  19th  Feb  1995
  13.                                        
  14.                             
  15.           THIS PROGRAM IS CAREWARE IT IS NOT PUBLIC DOMAIN
  16.           ================================================
  17.  
  18. The following have written permission to reproduce this software on
  19. their respective Careware disks :-
  20.  
  21.       Norwich Computer Services : Careware Disks
  22.       Alex Bar  (Furth Germany ): German Careware Disks
  23.  
  24. They will also be supplied with updates.
  25.  
  26. The Author will also upload it to Careware sections on Arcade and NCS bbs.
  27. From which it maybe downloaded.
  28.  
  29. It may NOT be uploaded by anyone other than the Author. 
  30.  
  31. It may NOT be reproduced by any other means ( other than above )
  32. without written consent of the author.
  33.  
  34. Arcade and NCS do NOT have authority to authorise copying by any means other than
  35. above.
  36.  
  37. Acknowledgements
  38. ================
  39.  
  40.   Thanks to the following for the supplying various sample CGM files
  41.  
  42.      Marc Lawrence, John Potter, Steve Hurst, Steve Ellacott, Barney Hamilton 
  43.      Frank K Carver, Andrew Pinder, Adrian Look.
  44.  
  45.                                
  46. !CGM->Draw
  47. ==========
  48. !CGM->Draw is a Utility for converting CGM Computer Graphics Metafiles
  49. to Acorn Draw files.
  50.  
  51. CGM Computer Graphics files can be produced by a number of PC graphics
  52. packages such as Freelance Plus and Harvard Graphics. 
  53.  
  54. It has been tested with Freelance V2.01, V3.01 and with a few sample
  55. files from :-
  56.  
  57.         Harvard Graphics.
  58.         CorelDraw
  59.  
  60. Installation
  61. ============
  62.  
  63. The Cgmdraw arc file should have been restored to a directory named
  64. !CGM->Draw. Which should contain the following files :-
  65.  
  66.  
  67.            !Run      : !CGM->Draw Startup file.
  68.            !Sprites  : !CGM->Draw Application Sprites
  69.            Cgm-draw  : !CGM->Draw Application.
  70.            ~~config  : Configuration file for CGM->Draw.
  71.            !Help     : This file.
  72.            Templates : Templates file for this application
  73.            !Palette  : Palette equivalent to default colours if CGM file
  74.                        does not contain a colour Table or direct colours.
  75.                        Changing this file will not have any effect on the
  76.                        application.
  77.  
  78.  
  79. Tailoring.
  80. =========
  81.  
  82.     The !run file should be altered to suite your requirements :-
  83.  
  84.     1) The Shared C Library should be loaded as appropriate for
  85.        your setup. The supplied !run file assumes that the C
  86.        shared library module is in !system.modules.
  87.  
  88.     2) cgmdraw$dir : Path to find config,template,!Palette file
  89.  
  90.     3) !CGM->Draw has been tested with a wimpslot size of 160k, lower
  91.        values maybe possible. The buffer used for the conversion
  92.        processing is claimed from the next slot. The space is return
  93.        immediately after the conversion, so you should not be able to
  94.        see the change. The next slot size must be large enough to 
  95.        hold the complete CGM file.
  96.        If !CGM->Draw prompts that it does not have enough memory to process, 
  97.        then !CGM->Draw must be restarted, having made provision that 
  98.        the next slot is large enough.
  99.  
  100.  
  101. Operation.
  102. ==========
  103.  
  104.      Clicking on the !CGM->Draw icon will install it on the icon bar.
  105.      Dragging cgm files to this icon will prompt for a draw file name
  106.      and conversion will take place.
  107.  
  108.  
  109. Direct Conversions/Wimp Pipes
  110. =============================
  111.       
  112.      If you are converting a number of files then you might like to use the
  113.      wimp pipes facility. Clicking on !CGM->Draw icon ( or via normal menus )
  114.      will bring up an options window.
  115.  
  116.      If the draw file icon is then dragged to a directory or application then a
  117.      a pipe is set up to that directory or application. Dragging a file or set
  118.      of files to the iconbar icon, will no longer prompt for a target file name but
  119.      automatically send the file to the relevant application or directory.
  120.  
  121.      
  122.  
  123.      For the above to work correctly with an application, the application must
  124.      support the data transfer protocol to at least wimp$scrap file level.
  125.  
  126.      Specifically the application must support
  127.  
  128.        1) The Dataload message.
  129.        2) The Datasave message.
  130.        3) The application must allow for the fact that both the source and destination
  131.           maybe an application and hence both source and destination could be the
  132.           <wimp$scrap> file. This is a consequence of the protocol and is often a 
  133.           stumbling block for conversion type programs.
  134.  
  135.      Unfortunately not all applications conform to the above. This applies to
  136.      so called professionally written software as well as Épublic domainæ.
  137.  
  138.      The application has successfully been tested with the following
  139.  
  140.          !Draw          0.44
  141.          !Draw 1/2      1.00
  142.          !DrwCGM        0.9b
  143.          !PCDir         1.0e
  144.          !Impression    2.03
  145.          !Draw->CGM     BetaTest
  146.          !DrawPlus      2.00
  147.  
  148.      A number of other options are made through the options window.
  149.  
  150.        1) warning message prompts may be suppressed.
  151.        2) warning messages may be directed to disk . ( In the !Drw->Cgm directory ).
  152.        3) A trace file may be directed to disk. (  In the !Drw->Cgm directory ).
  153.  
  154. Metafile Translation
  155. ====================
  156.  
  157.      The Graphics Metafile support is fairly comprehensive, but not complete.
  158.      A number of functions are not supportable by draw. e,g. pattern fills
  159.      text at an angle. etc.
  160.  
  161.      Some other functions have not been implemented. This is due to the fact
  162.      that I cannot easily generate test cases for all functions. The
  163.      functions supported should cater for Freelance and Harvard Graphics
  164.      produced files.
  165.                              
  166.      Metafile orders greater than 32k are not yet supported.
  167.      One exception is cell arrays greater than 32k.
  168.  
  169.      If you come across a missing function then you will receive a relevant
  170.      popup window. I am keen to obtain test cases for as yet 
  171.      unsupported metafile elements in order to improve the program.
  172.  
  173.      Similarly if you have some files that will not convert properly,
  174.      then again I would be very interested. Please contact me through
  175.      either of the two Bulletin Boards Arcade bbs, NCS bbs.
  176.  
  177. Restrictions
  178. ============
  179.  
  180.      Max colour index is limited currently to 1024, this restriction can easily be
  181.      lifted upon request.
  182.  
  183.      Draw only supports a background colour of white ( colour 0 ). Some lines,areas,shapes
  184.      extra ,may be white on a non-white background. These therefore need to be edited
  185.      when in draw. i.e. if you get a blank picture try select all and change line style to
  186.      colour black.
  187.  
  188.      Risc OS v2/v3 Draw does not support patterned fills.
  189.  
  190.      Multiple CGM Pictures in one file are only supported if the pictures are on the
  191.      same page.
  192.  
  193.      Polygon set edge visibility is not 100% supported, to be improved in later release.
  194.  
  195. Config File.
  196. ===========
  197.  
  198.        The config file controls font translation.
  199.  
  200.        The first entry is the number of font entries.
  201.        
  202.        The appropriate number of font entries then follow.
  203.  
  204.        A font entry consistæs of :-
  205.  
  206.           An Acorn Font name.
  207.           The cgm font number + 1          ( Integer ). NOT zero !!!!!
  208.           height adjustment multiplier     ( Integer ).
  209.           height adjustment divisor        ( Integer ).
  210.  
  211.        Height adjustment 
  212.  
  213.           The height read from the CGM file is adjusted as follows
  214.  
  215.              ( height * multiplier ) / divisor.
  216.  
  217.        Following the fonts is marker controls
  218.  
  219.        Font number for markers             (integer)
  220.  
  221.        Characters in Marker font           (string upto 16 characters)
  222.  
  223.        The CGM standard states that
  224.  
  225.              marker 1 : Is a dot
  226.              marker 2 : plus
  227.              marker 3 : asterisk
  228.              marker 4 : circle
  229.              marker 5 : cross 
  230.  
  231.         negative values are private and are mapped to 6 by CGM->Draw 
  232.         i.e. marker -1 = offset 6 in string,
  233.              marker -2 = offset 7 in string
  234.              etc.
  235.               
  236. Copyright, Terms of Use & Contributions
  237. =======================================
  238.  
  239. This software carries no warranty, either express or implied. 
  240. I can not guarantee that it is free of bugs or give any warranty
  241. about itæs suitability for use.
  242.                                                    
  243. The status of !CGM->Draw is Careware.
  244.  
  245. Permission is granted to Norwich Computer Services to reproduce !CGM->Draw on Careware disks.
  246.  
  247. The software will be uploaded to Careware sections on Arcade and Archive Bulletin Boards,
  248. it may only be uploaded by the author. It may not be uploaded by anybody else or
  249. to any other board.
  250.                             
  251. This software may NOT be distributed by public domain libraries.
  252.  
  253. If you did not obtain the software from a Careware disk or by subscription to one of the
  254. Bulletin Board Careware sections. ( i.e. You obtained it from a friend who does, say. ) 
  255. Then please send a contribution to either
  256.  
  257. Heatherley Cheshire Home
  258. Effingham Lane,
  259. Copthorne,
  260. Sussex.
  261. RH10 3HS.
  262.  
  263.  
  264. Registered Charity Number : 218186
  265.  
  266. The software may not otherwise be copied or distributed without
  267. the Authors written permission.
  268.  
  269.  
  270. Copyright remains soley the authors. (C) Keith Sloan 
  271.  
  272. [ User:  Keith Sloan    on ArcadeBBS  : London  ]
  273.  
  274.  Fidonet  : Keith Sloan @ 2:254/7.0
  275.  Internet : keiths@uk.co.compulink.cix
  276.  
  277. [ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  278.  
  279.   No comms access at present.
  280.   Following house move , serial port appears to
  281.   be broken
  282.  
  283. ] !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  284.  
  285. Version History
  286. ---------------
  287.  
  288.     1.0       First version.      ( October 1990 )
  289.  
  290.     1.1       Number of bugs fixed to do with arcs of circles ( mostly  filled ).
  291.               Support added for cell arrays and 3 point circles.
  292.               These are both untested as I do not have access to any software that
  293.               uses these CGM elements. If you find CGM files which case Cell array
  294.               warnings or arc 3pt circle warnings, I would be very interested in
  295.               obtain such files for future testing.
  296.  
  297.     1.2       Tested with CoralDraw
  298.               Default vdc precision set.
  299.               Colour table with more than one entry.
  300.               iconbar sprite changed from mode 86 to 12
  301.               winding set to odd-even.
  302.  
  303.     1.3       Add support for cell arrays.
  304.  
  305.     1.4       Add support for Polygon set.
  306.  
  307.     1.5       Button click on wimp pipe name changes text alignment.
  308.               to allow for long path names.
  309.  
  310.     1.6       Translation colour table fully initialised in case CGM
  311.               file forgets to include background colour in colour table.
  312.  
  313.     1.7       Fixes for CGM file of dubious origin.
  314.  
  315.     1.8       Max colour index increased from 256 to 1024.
  316.               Better file handling.
  317.               Various other small fixes.
  318.  
  319.     1.9       Perimeter elements corrected from draft to full standard
  320.  
  321.     2.0 & 2.1 Fixes for WPCorp created files, should no longer abort on unknown element
  322.               Character set elements added. ( Default max colour values fixed in 2.1 )
  323.  
  324.     2.2       Fixes for WPCorp created files, ( uses a max colour index of 0 then goes
  325.               ahead and uses direct colours [strange] )
  326.  
  327.     2.3       Fix for filled ellipse producing closed figure with incorrect length.
  328.  
  329.     2.4  Nov 1991
  330.  
  331.               Support for edge visibility element
  332.               Negative VDC shifted to zero.
  333.               Fix for arc of ellipse and arc ellipse close
  334.               Allow for polylines with only one point ( Looks like product of CorelTrace )
  335.  
  336.     2.5  Apr 1992
  337.  
  338.               Support for restricted text
  339.               Improved handling of multiple segments ( remove bug for gt 2 )
  340.               Scaled width
  341.               Multiple pictures on same page.
  342.  
  343.     2.6 Jun 1992
  344.               
  345.               Fix for Polgon set with greater than one closure.
  346.  
  347.     2.7 Jan 1995
  348.  
  349.               Support Text at an Angle
  350.               Support for Markers
  351.  
  352.     2.8 Jan 1995
  353.  
  354.               ( Whoops some more fixes in the evening )
  355.               Fix  : Colour precision used instead of colour index precision
  356.               Fix  : ellipse when offsets are non-zero
  357.  
  358.     2.9 Feb 1995
  359.  
  360.              Default colour 0 to white ( some PC CGM have different defaults ) 
  361.  
  362.  
  363. Known Problems
  364. ==============
  365.  
  366.     Bug in Ellipses at an angle.
  367.  
  368.     Really want to restructure code as per !WMF->Draw and !Met->Draw
  369.     for ellipses. So need to do some recoding and a lot of re-testing for
  370.     ellipses at angles etc
  371.  
  372.